Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGSetChannelBounds

The SGSetChannelBounds function allows you to specify a channel's display boundary rectangle. This rectangle defines the destination for data from this channel. This rectangle is defined in the graphics world you establish by calling the SGSetGWorld function, described on page 5-27.

pascal ComponentResult SGSetChannelBounds (SGChannel c,
                                           const Rect *bounds);

c

Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.

bounds

Contains a pointer to a rectangle that defines the channel's display boundary rectangle. This rectangle is defined in the graphics world you establish when you call the SGSetGWorld function, described on page 5-27.

DESCRIPTION

You cannot call the SGSetChannelBounds function during a record operation.

SPECIAL CONSIDERATIONS

The SGSetChannelBounds function adjusts the channel matrix, as appropriate.

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
notEnoughMemoryToGrab	-9403	Insufficient memory for record operation
deviceCantMeetRequest	-9408	Device cannot support grabber component

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help